updateSongs

Updates fields on one or more existing songs.

Sample Request

<mmRequest command="updateSongs" station="ID" [version="1"] [client=""] [userData=""]>
	<contents>
		<songList>
			<song [songId="1"] [cutId="x"] [catId="1"] [category="A"]>
				<field id="108">NewValue</field>
			</song>
		</songList>
	</contents>
</mmRequest>

Request Notes

The actual update request is provided in the contents/songList section.

 

Include one song tag for each song you wish to update. The songId attribute must specify the MusicMaster id number of the song to update. Alternatively, you may use the cutId attribute to specify the song. For each song, specify one or more FIELD tags. You should only include field tags for the fields you wish to update. Any existing values will be replaced with the data provided. The field tag requires an id attribute with internal field ID number, or a name attribute with the user-defined field name. You can obtain a list of available fields with the command. The value of the tag should be the data you want to write to the database.

 

You can also specify the category so when a song is in more than one category, you can target the specific instance you wish to work with. You can do this either by category ID (available via getCategoryList) or by the actual user category code.

Sample Reply

<mmReply command="updateSongs" station="ID" version="1" [userData=""] status="ok" />

Compatibility and Version Info

Available in all versions

Added cutId support with API revision 5005